Parameters for License Search
This section describes parameters that you can use in a custom search query.
Parameter | Description |
---|---|
id |
The eight digits in the middle part of a license number. Supported formats:
Examples:
|
code |
A license activation code. If it contains hyphen signs (“-“), use double quotation marks when you specify the code. For example: |
product |
The product name alias. Aliases are used instead of product names for a more convenient search. For the list of aliases refer to Product Name Aliases. For example: |
type |
The type of a license. Possible values: Examples:
|
keyinfo |
The description of a license (the License information column in the list of licenses) that users cannot change. For example: |
desc |
A short description of a license that is added by users. Examples:
|
note |
The text of a note assigned to a license. Examples:
|
status |
The status of a license. Possible values: Examples:
|
isEls |
This parameter is used to search for licences charged or not charged within Extended Lifecycle Support. Possible values: Examples:
|
addon |
This parameter is used to find licenses that have certain features. Features are attributes that you select when you purchase a license, such as the maximum number of domains or Plesk Power Pack support. For example: This search query finds licenses that have the features whose names contain the text “30 dom”. In other words, if a feature name contains “30 domains”, “230 domains”, “330 dom”, and so on, then the licenses that have this feature will be displayed in search results. The Examples:
This query finds all licenses whose addon features have the name “tomcat server” and this feature is purchased.
This query finds all licenses that have both the specified addon features, and the feature names exactly match the specified values. It also takes into account the billing model: It finds “tomcat server” feature that is purchased, and “100 sites” feature that is leased.
This query finds all licenses that have any of the specified addon features, and the feature names contain the specified values (exact matching is not necessary). It also takes into account the billing model: It finds “Premium Antivirus” that is purchased, and “cloudflare” that is leased. You can specify the duration of lease:
For example:
This query finds all licenses whose addon features contain words “100 sites” in their name and these feature are leased for a two-year period. |
parent |
The number of a parent license key. Supported key number formats:
Examples:
|
owner |
The license owner’s name or account ID. Examples:
|
reseller |
The reseller account to which a license owner’s account is subordinate, either directly or indirectly. Examples:
This query finds licenses whose owner’s account is subordinate to the reseller with ID=1234567.
This query finds licenses whose owner’s account is not subordinate to reseller accounts that have “tech” or “technologies” in their names. |
list |
The list parameter is used for finding licenses that have
numbers matching the numbers from a user-specified list. The
list of numbers is saved automatically with some ID. The
list parameter takes this ID as a value. Learn more in
Searching by a List of License Numbers. |
guid |
An attribute that is bound to a license, such as server’s hardware ID for PVC licenses, domain name for APS application licenses, and so on, depending on the type of product. For example: |
keyip |
An IP address to which the license is bound by the user. This address is not necessarily the same as the actual IP address of the server where the corresponding product is installed. Such a parameter is useful for searching when the license number and activation code are not known. Examples:
|
keyversion |
This parameter is used to search for licenses that are applicable to a certain product version. The product version here is the version specified in the license properties. Note: If you specify a major version (such as 9), all minor versions of this major version (such as 9.1, 9.5 and so on) will also be included in the search results. Examples:
|
keyos |
This parameter is used to search for licenses that are applicable to a certain type of operating system. This is the type of operating system specified in the license properties. Possible values: Examples:
|
keyplatform |
The type of platform specified in a license properties.
Possible values: Examples:
|
keydomains |
The limit on the number of domains (for licenses that support
such a limit). Possible values: positive integer numbers and
Examples:
|
keysites |
The limit on the number of websites (for licenses that support
such a limit). Possible values: positive integer numbers and
Examples:
|
keypowerpack |
This parameter is used to search for licenses with or without
Plesk Power Pack. Possible values: For example: |
version |
This parameter is used to search for licenses by the product version reported by the server where a license is installed (as opposed to the version specified in the license properties). Note: If you specify a major version (such as 9), all minor versions of this major version (such as 9.1, 9.5, and so on) will also be included in the search results. Examples:
|
update |
Use the Example:
|
os |
The operating system reported by the server where a license is installed (as opposed to the type of operating system specified in the license properties). You can obtain all operating system names and versions reported to Partner Central and use them in your search. For this, open the report Licenses by OS (on the Reports tab) and view its column Operating System. Examples:
|
ip |
The IP address of the server where the product with the corresponding license is installed. This address can be either the IP address to which the license is bound by the user or the IP address reported by the server where the license is installed. Examples:
|
conf |
The name or a part of the name of the product configuration with which a license is associated. For example: |
|
These parameters are used to filter licenses by SUS expiration
date ( You can specify the date in any of the following formats:
Examples:
|
|
These parameters are used to filter licenses by date of their creation, termination, or expiration. You can specify the date in any of the following formats:
Examples:
|
fraud |
Indicates that a license is detected as being used on multiple Plesk servers.
Possible values: Examples:
|
keyiprestriction |
The type of IP binding restriction behavior. Possible values:
Examples:
|
sku |
SKU is a code which relates to key types and is assigned to license keys on creation. If the SKU contains one or more hyphen characters (“-“), use double quotation marks when you specify it. Examples:
|
autorenewal |
Whether automatic renewal is enabled for the license or not. Possible values:
Examples:
|
nextupdate |
This parameter is used to filter licenses by the next update date. You can specify the date in any of the following formats:
Examples:
|